home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr25 / syscl2.zip / SYSCOLS.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-03-03  |  14KB  |  449 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. PM System Color Keys ΓòÉΓòÉΓòÉ
  3.  
  4. Accelerator mnemonic keys: 
  5.  
  6. F3 
  7.    Exit 
  8.  
  9. F1 
  10.    Help 
  11.  
  12.    Reset 
  13.  
  14.    reaD 
  15.  
  16.    Keep 
  17.  
  18.    Write 
  19.  
  20.    Set 
  21.  
  22.    deLete 
  23.  
  24.    seT 
  25.  
  26.    saVe 
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 2. Extended Help for PM System Colors ΓòÉΓòÉΓòÉ
  30.  
  31. This program offers configuration of OS/2 Presentation Manager's system colors. 
  32. Features include: 
  33.  - All 41 system colors can be changed.  whereas the .........Control 
  34. Panel........ only allows configuration of 26 colors. 
  35.  - Most color changes are visible immediately. 
  36.  - Sample Color Templates are available.  Additional Templates can be created, 
  37. or existing ones can be modified. 
  38.  - Colors can be set temporarily or permanently. 
  39.  - A color template can be loaded from the command line (ideal for use in .CMD 
  40. files). 
  41.  
  42. The system colors in OS/2 1.x are: 
  43.  
  44. ButtonLight - Top and left edges of scrollbar slider box 
  45. ButtonMiddle - Scrollbar slider box and pushbuttons 
  46. ButtonDark - Right and botton edges of scroll bar slider box 
  47. ButtonDefault - Outline of default pushbutton 
  48. TitleBottom - Thin line outlining action or menu bar 
  49. Shadow -  Shadow around edge of pull down menus 
  50. IconText -  Text under icons 
  51. DialogBackground -  Background for dialogue boxes 
  52. HiLiteForeground - Text of hilighted selection 
  53. HiLiteBackground - Hilighted selection menu bar 
  54. InActiveTitleTextBgnd - Inactive title-text background 
  55. ActiveTitleTextBgnd - Active title-text background 
  56. InActiveTitleText - Text of menu or action bar on inactive windows 
  57. ActiveTitleText - Text of menu or action bar on active window (window with 
  58. focus) 
  59. OutputText - Appears in dialogue boxes as default text in entry fields 
  60. WindowStaticText - Static window text 
  61. ScrollBar - Background for scroll bar (note: not slider box) 
  62. Background - Screen background 
  63. ActiveTitle - Text on title bar of active window 
  64. InActiveTitle - Text on title bar of inactive window 
  65. Menu - Menu or action bar background 
  66. Window - Background of window 
  67. WindowFrame - Thin border line outlining all windows 
  68. MenuText - Text of menu or action bar 
  69. WindowText - Window normal text 
  70. TitleText - Title text 
  71. ActiveBorder - Border around active window (window with focus) 
  72. InActiveBorder - Border around inactive windows 
  73. AppWorkSpace - Application background 
  74. HelpBackground - Background for help screens 
  75. HelpText - Text for help screens 
  76. HelpHiLite - Highlighted text for help screens 
  77.  
  78. OS/2 2.0 added the following colors: 
  79.  
  80. ShadowHiLiteBgnd - Background of shadowed icon text 
  81. ShadowHiLiteFgnd - Foreground of shadowed icon text 
  82. ShadowText - Shadowed icon text 
  83. EntryField - Background of entry fields 
  84. MenuDisabledText - Text of disabled menu options 
  85. MenuHiLiteText - Text of hilighted menu options 
  86. MenuHiLite - Background of hilighted menu options 
  87. PageBackground - Tabs and outline on certain Notebook controls (Find is one 
  88. example) 
  89. FieldBackground - Tabs and outline on Notebook controls 
  90.  
  91. Note that with OS/2 2.0, depending on the color used as the background (Window) 
  92. for pop-up folders, you may have to change the Icon Text used in individual 
  93. folders so that it is visible. 
  94.  
  95. (*) indicates that only pure colors can be applied to this system object 
  96. (+) non-pure colors can be applied to scroll box slider buttons, but not to 
  97. push buttons. 
  98. Apparently, Presentation Manager does it's best to find matching display colors 
  99. for the colors you choose, however for colors applied to certain system 
  100. objects, the results may be different from that displayed in the sample color 
  101. area.  This is most likely due to Presentation Manager's rejection of dithered 
  102. colors for some settings.  Those system objects that do not seem compatible are 
  103. marked with (*). 
  104. (=) On the OS/2 systems I have had experience with, setting colors for these 
  105. system objects has no visible effect.  I'm not positive where these system 
  106. objects appear, but apparently they have something to do with 'Function Key 
  107. Areas'.  At any rate, they are documented as system colors and may very well be 
  108. "reserved for future use"  items.  If anyone can provide a screen or 
  109. application where these colors appear, I would greatly appreciate the 
  110. information. 
  111.  
  112. Actions for PM System Color Configuration: 
  113.  
  114. The following actions may be invoked by clicking on the pushbutton 
  115. corresponding to the action, or by pressing the letter corresponding to the 
  116. underlined mnemonic character. 
  117.  
  118.    Reset to original colors 
  119.  
  120.    Read data file containing color codes to set 
  121.  
  122.    Keep current screen colors for future sessions (Save to OS/2's .INI file) 
  123.  
  124.    Write current color codes to data file 
  125.  
  126.    Set colors to those defined by the color template selected in the Color 
  127. Templates list box 
  128.  
  129.    Default sets system colors item (i.e. Icon Text, Window Text, Background) to 
  130. OS/2's default color 
  131.  
  132.    Delete color template 
  133.  
  134.    Set system colors item (i.e. Icon Text, Window Text, Background) to the 
  135. color displayed in the sample color region 
  136.  
  137.    Save the currently selected system colors item and the color selected in the 
  138. sample area to an existing or new Color Template 
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 3. Help for Reset ΓòÉΓòÉΓòÉ
  142.  
  143. This action resets the colors back to the ones which were active when this 
  144. program was invoked  (which may or may not be OS/2's original colors depending 
  145. upon if you have changed them with other OS/2 utilities. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 4. Help for Read ΓòÉΓòÉΓòÉ
  149.  
  150. This action reads a data file containing color codes to set.  The data file 
  151. must be a pure ASCII text file containing one line for each of the 41 colors. 
  152. If you like the colors loaded from the data file, use the action Save to save 
  153. the colors to a template name. 
  154.  
  155. The order of the colors in the data file is as follows: 
  156.  
  157.  1. ShadowHiLiteBgnd 
  158.  
  159.  2. ShadowHiLiteFgnd 
  160.  
  161.  3. ShadowText 
  162.  
  163.  4. EntryField 
  164.  
  165.  5. MenuDisabledText 
  166.  
  167.  6. MenuHiliteText 
  168.  
  169.  7. MenuHilite 
  170.  
  171.  8. PageBackground 
  172.  
  173.  9. FieldBackground 
  174.  
  175. 10. ButtonLight 
  176.  
  177. 11. ButtonMiddle 
  178.  
  179. 12. ButtonDark 
  180.  
  181. 13. ButtonDefault 
  182.  
  183. 14. TitleBottom 
  184.  
  185. 15. Shadow 
  186.  
  187. 16. IconText 
  188.  
  189. 17. DialogBackground 
  190.  
  191. 18. HiLiteForeground 
  192.  
  193. 19. HiLiteBackground 
  194.  
  195. 20. InActiveTitleTextBgnd 
  196.  
  197. 21. ActiveTitleTextBgnd 
  198.  
  199. 22. InActiveTitleText 
  200.  
  201. 23. ActiveTitleText 
  202.  
  203. 24. OutputText 
  204.  
  205. 25. WindowStaticText 
  206.  
  207. 26. ScrollBar 
  208.  
  209. 27. Background 
  210.  
  211. 28. ActiveTitle 
  212.  
  213. 29. InActiveTitle 
  214.  
  215. 30. Menu 
  216.  
  217. 31. Window 
  218.  
  219. 32. WindowFrame 
  220.  
  221. 33. MenuText 
  222.  
  223. 34. WindowText 
  224.  
  225. 35. TitleText 
  226.  
  227. 36. ActiveBorder 
  228.  
  229. 37. InActiveBorder 
  230.  
  231. 38. AppWorkSpace 
  232.  
  233. 39. HelpBackground 
  234.  
  235. 40. HelpText 
  236.  
  237. 41. HelpHiLite 
  238.  
  239. OS/2 specifies colors with 24 bits of Red-Green-Blue intensity information. 
  240. Since there are 8 bits for each color, the valid ranges are from 0 to 255. The 
  241. integers represent the Red, Green, and Blue components of an RGB color value. 
  242.  
  243. Some example colors are: 
  244.  
  245. White   255  255  255
  246. Yellow  255  255    0
  247. Pink    255    0  255
  248. Cyan      0  255  255
  249. Blue      0    0  255
  250. Green     0  255    0
  251. Red     255    0    0
  252. Black     0    0    0
  253.  
  254. The data file should contain a line for each of the 41 colors in the order 
  255. outlined above.  The leftmost integer is the Red value, the middle integer is 
  256. the Green value, and the rightmost integer is the Blue value. 
  257.  
  258. Sample data file: 
  259.  
  260. 128 128 128
  261. 255 255 255
  262. 128 128 128
  263. 255 255 204
  264. 128 128 128
  265.   0   0   0
  266. 204 204 204
  267. 255 255 255
  268. 204 204 204
  269. -----------
  270. 255 255 255
  271. 204 204 204
  272. 128 128 128
  273. 0 0 0
  274. 128 128 128
  275. 128 128 128
  276. 0 0 0
  277. 204 204 204
  278. 255 255 255
  279. 128 128 128
  280. 204 204 204
  281. 64 128 128
  282. 128 128 128
  283. 255 255 255
  284. 0 0 0
  285. 0 0 128
  286. 192 192 192
  287. 128 128 128
  288. 64 128 128
  289. 204 204 204
  290. 204 204 204
  291. 255 255 255
  292. 128 128 128
  293. 0 0 0
  294. 0 0 0
  295. 255 255 255
  296. 255 255 128
  297. 204 204 204
  298. 255 255 224
  299. 255 255 255
  300. 0 0 128
  301. 0 128 128
  302.   --------------- 255 255 255 204 204 204 128 128 128  0  0  0 204 204 204 128 
  303. 128 128  0  0  0 255 255 255 255 255 255  0  0  0  0  0  0  0  0  0  0  0  0 
  304. 255 255 255  0  0  0  0  0 128 224 224 224 192 192 192  0  64 128 255 255 255 
  305. 255 255 255 255 255 255  0  0  0  0  0  0  0  0  0 255 255 255 128 128 128 255 
  306. 255 255 255 255 232 255 255 255  0  0 128  0 128 128 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 5. Help for Keep ΓòÉΓòÉΓòÉ
  310.  
  311. This action saves the current colors for future sessions by writing to OS/2's 
  312. OS2.INI file.  OS2.INI is an initialization file that OS/2 processes when the 
  313. system is started. 
  314.  
  315.  
  316. ΓòÉΓòÉΓòÉ 6. Help for Set Color Template ΓòÉΓòÉΓòÉ
  317.  
  318. This action sets the system colors to the colors defined by the currently 
  319. highlighted selection in the Color Templates list box. 
  320.  
  321. To reset the colors back to the ones which were active when this program was 
  322. invoked, click the Reset pushbutton. 
  323.  
  324. When the program loads, it searches the current directory for it's own .INI 
  325. file to load the Color Template names.  If the .INI file is not found, a 
  326. message box is displayed. 
  327.  
  328. If you exit (close) this program (without selecting Keep), the colors will 
  329. remain in effect, however, when the system is shutdown and brought back up 
  330. again, the "original" colors will once again be in effect (since the colors 
  331. were not saved to OS/2's OS2.INI file with the Keep action). 
  332.  
  333. A Color Template name can be specified on the command line. If a parameter is 
  334. given on the command line, the interactive Presentation Manager screen will not 
  335. be invoked. 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 7. Help for Delete ΓòÉΓòÉΓòÉ
  339.  
  340. This action removes a Color Template.  Since you cannot "undelete" a color 
  341. template, you will be prompted to confirm the deletion. 
  342.  
  343. This action removes a Color Template.  Since you cannot restore a deleted color 
  344. template, you will be prompted to confirm the deletion. 
  345.  
  346.  
  347. ΓòÉΓòÉΓòÉ 8. Help for Set System Color Item ΓòÉΓòÉΓòÉ
  348.  
  349. This action sets the currently selected system item (i.e. WindowStaticText, 
  350. ScrollBar, Background, etc.) in the System Colors listbox to the color 
  351. currently displayed in the sample color region.  This action affects only the 
  352. currently selected system item. 
  353. Selecting Reset or Set Color Template will override the individual colors 
  354. previously set with this option. 
  355.  
  356. The Color Template "Different", although some may think it ugly, serves to 
  357. demonstrate each system item as a different color. 
  358.  
  359.  
  360. ΓòÉΓòÉΓòÉ 9. Help for Save to Color Template ΓòÉΓòÉΓòÉ
  361.  
  362. This action saves the current system colors to an existing or new Color 
  363. Template.   The default color template to save to is the one highlighted in the 
  364. Color Templates list box, however, another template can be specified. 
  365.  
  366. To build (or modify) a template, select the system color item in the System 
  367. Colors listbox that you want to change (i.e. Icon Text, WindowText, Background, 
  368. etc.), use the scrollbars to choose a color, then use Set (next to the System 
  369. Colors listbox) to test the color.  Then, optionally, use save to save the 
  370. changes to a Color Template. 
  371.  
  372.  
  373. ΓòÉΓòÉΓòÉ 10. Help for Write Data File ΓòÉΓòÉΓòÉ
  374.  
  375. This action writes the current color setting codes to a file.  This is handy to 
  376. transfer color setting between systems.  If a friend has colors that you would 
  377. like to add to your Color Templates, simply have him/her save their colors to a 
  378. data file, then use Read to load the colors on your system, and optionally save 
  379. them to a Color Template. 
  380.  
  381.  
  382. ΓòÉΓòÉΓòÉ 11. Loading Templates from Command Line ΓòÉΓòÉΓòÉ
  383.  
  384. A Color Template name can be specified on the command line. 
  385. Command line syntax is: 
  386.  
  387. SYSCOLS ["]templatename["] [/L] 
  388.  
  389. where templatename is space-sensitive but not case-sensitive, and /L indicates 
  390. to load the main System Colors Configuration Presentation Manager screen after 
  391. changing the colors. 
  392.  
  393. Specifying Color Templates on the command line without loading the main screen 
  394. is useful for .CMD files, especially if you run a program that conflicts with 
  395. your default color choices.  Simply put the lines 
  396.  
  397. SYSCOLS "newtemplatename" 
  398. <commands to run confliciting program> 
  399. SYSCOLS "default or oldtemplatename" 
  400.  
  401. in a .CMD file to set colors compatible with the program, run the program, and 
  402. then set the colors back to your favorite selection. 
  403.  
  404. No action is taken if the Color Template name given on the command line is not 
  405. found in this program's .INI file.  Note that the Color Template name is not 
  406. case sensitive, but if the Color Template name consists of two or more words, 
  407. the template name must be enclosed in " ". 
  408.  
  409. For example, 
  410. SYSCOLS "Penn State"    is valid 
  411. SYSCOLS "penn state"    is valid 
  412. SYSCOLS "pEnN sTaTe"    is valid 
  413. SYSCOLS penn state    is not valid 
  414. SYSCOLS pennstate    is not valid 
  415. SYSCOLS PennState    is not valid 
  416.  
  417. If a paramter is given on the command line, the program simply searches for the 
  418. Color Template in the .INI file, and if it is found, the system colors are 
  419. changed.  If the template name is not found, the colors do not change. In 
  420. either case, the Presentation Manager interactive screen is not invoked unless 
  421. /l or /L is given as the second parameter. 
  422. SYSCOLS "penn state"  /l   would change the colors and load the program. 
  423. SYSCOLS "invadid template"  /l   would not change the colors, however the main 
  424. System Colors Configuration Presentation Manager screen would be loaded 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ 12. Help for Default ΓòÉΓòÉΓòÉ
  428.  
  429. This action sets the currently selected system item (i.e. WindowStaticText, 
  430. ScrollBar, Background, etc.) in the System Colors listbox to OS/2 2.0's default 
  431. color.  This action affects only the currently selected system item. 
  432.